home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 676-700 / 696 / drivers / drivers.lha / CanonBJ10-20 / Readme < prev    next >
Text File  |  1992-07-12  |  59KB  |  1,363 lines
  1.                           Trademarks
  2.                           ----------
  3.  
  4. Amiga is a registered trademark of Commodore-Amiga, Inc.
  5. Kickstart is a registered trademark of Commodore-Amiga, Inc.
  6. Workbench is a registered trademark of Commodore-Amiga, Inc.
  7. PostScript is a trademark of Adobe Systems Incorporated.
  8. PageStream is a registered trademark of Soft-Logik Publishing Co.
  9. Professional Page is a trademark of Gold Disk Inc.
  10. AGFA, Compugraphic and Intellifont is a registered trademark of AGFA
  11.  
  12. All  other  trademarked  product and company names used herein are
  13. used   for  identification  purposes  only.   No  infringement  of
  14. trademarks   is  intended.   Trademarks  remain  property  of  the
  15. trademark holder.
  16.  
  17.  
  18.           Warranty, Registration, Support and Upgrades
  19.           --------------------------------------------
  20.  
  21. Copyright   ©   1992   Wolf  Faust.   All  rights  reserved.   All
  22. distribution-  and  marketing  rights to the software (driver) are
  23. vested in Canon Europa N.V.
  24.  
  25. The  driver  has  been  provided  to you strictly 'as is', without
  26. warranty  of  any  kind.   In no event shall Canon and/or Faust be
  27. held  liable  for  any  loss or damages arising out of any action,
  28. from  whatever  source, concerning the use or inability to use the
  29. driver.
  30.  
  31. For  obtaining a copy of the driver, or for more information about
  32. Amiga driver, please contact your local Canon representative.
  33.  
  34. Following driver revisions have been made:
  35.  
  36. 22.07.91     Version 1.1
  37. 27.11.91     Version 1.2  Version for Commodore
  38.              + set presentation highlight removed for BJ300/330 printers
  39. 09.12.91     Version 1.3  Further changes for the BJ300 made
  40. 20.04.92     Version 3.0  major update:
  41.              + arXon support added       + new WB paper sizes added
  42.              + I' accent fixed           + CanonBeep option added
  43.              + CanonTime option added    + CanonResX option added
  44.              + CanonConv option added    + CanonTab  option added
  45.              + CanonPerf option added    + CanonTop  option added
  46.              + CanonForm option added    + CanonFont option added
  47.              + FontShop program added    + CanonPref program added
  48.              + Report program added      + aTBCALL command fixed
  49.              + Check for MemCpy() fixed  + MemCpy()/MemClr() improved
  50.              + most text style commands changed
  51.                for download font usage
  52. 01.06.92     Version 4
  53.              - changes in the documentation
  54.              - a small bug in MemCpy() fixed, causing chars to appear in
  55.                dark graphics
  56.              - misaligned slider in CanonPref fixed
  57.  
  58.                           Thanks to
  59.                           ---------
  60.  
  61. Several  people were involved during the writing of the driver and
  62. documentation.   To  all of them, thank you!  Also I would like to
  63. thank  all  the people who registered the previous driver release.
  64. Without  their  support  and  letters, this driver surely wouldn't
  65. exist.  Keep on supporting the Amiga community!
  66.  
  67.                            Contents
  68.                            --------
  69.  
  70. This  disk  contains  a printer driver for use with the Canon BJ10
  71. ,BJ10ex  and  BJ20  printers and Commodore Amiga computers.  Note,
  72. there  are special driver version available for the BJ130,300,330,
  73. LBP and BJC printers!
  74.  
  75. The following files are included on the disk:
  76.  
  77. "CanonBJ10" -  The printer driver revision 3
  78. "FontShop"  -  A KS 2.0 (or higher) font download program
  79. "CanonPref" -  A KS 2.0 (or higher) driver preferences program
  80. "Install"   -  Workbench install program for the CanonBJ10 driver
  81. "Report"    -  A report program telling your preferences/driver settings
  82. "Readme"    -  The documentation file (and/or printed manual)
  83.  
  84.                Highlights of the CanonBJ10 driver
  85.                ----------------------------------
  86.  
  87. - automatic font download to the printer
  88. - builtin support for the arXon electronic centronic switch box
  89. - very fast graphic dumps
  90. - automaticly uses improved code for 68020/30 processors if available
  91. - fully supports WB 1.3, 2.0 and 2.1(!)
  92. - all margins are definable
  93. - paper size is freely definable
  94. - comes with an extra KS 2.0 preferences program for controlling the driver
  95. - install program supplied
  96. - font download program
  97. - full documentation (should be normal, but it's not!)
  98. - free definable tab stops
  99. - free definable greyscale conversion
  100. - job end signal
  101.  
  102.                       System requirements
  103.                       -------------------
  104.  
  105. The  CanonBJ  driver is compatible with the entire family of Amiga
  106. computers.   These  include  the  A500, A500+, A600, A1000, A2000,
  107. A2500,  A2500/30  and A3000 computers.  The driver was designed to
  108. run  under Workbench versions 1.3, 2.0 and 2.1.  The CanonPref and
  109. FontShop program was designed to run under Workbench 2.0 and 2.1.
  110.  
  111. The  CanonBJ10 driver was designed for the Canon BJ10e, BJ10ex and
  112. BJ20 printers.
  113.  
  114.  
  115.  
  116.  
  117.                          Installation
  118.                          ------------
  119.  
  120. 1. Setup  and connect your BJ-10 as described in the BJ-10 Users
  121.    Manual.
  122. 2. Set the printers DIP Switches as follows:
  123.  
  124.    Switch         Function                 Setting
  125.   
  126.     1       Auto Sheet Feeder            As Appropriate
  127.     2       Graphics image density       As Appropriate
  128.     3       Automatic Line Feed          OFF
  129.     4       Page length                  On Europe/Australia / OFF USA
  130.     5       Character Set                ON
  131.     6       Automatic carriage return    OFF
  132.     7       Alternat graphics mode       OFF
  133.     8       buffer/download memory       OFF (for font download: ON!)
  134.     9       Code page                    OFF
  135.    10       Printer control mode         ON
  136.   
  137. 3. Boot your Amiga with your usual System Disk
  138. 4. Insert  the  Canon  Driver  Disk  and  select the appropriate
  139.    "Drawer" for the printer.
  140. 5. Double Click on the "Install" program. The "Install" program
  141.    will copy the driver on to the system disk.
  142.    If there is not enough free disk space to install the
  143.    printer driver a requester will pop up saying so. In this
  144.    case free up some disk space on your system disk by
  145.    deleting unused files.
  146.    If you are a CLI user, simply copy the driver into your
  147.    "devs:printers" directory
  148. 6. Start Preferences on your system disk (if you own Kickstart
  149.    2.0 use the printer preference program). Select the CanonBJ10
  150.    driver and adjust all other preference parameters to your
  151.    environment. See your system manual for more information
  152.    about the preference program. 
  153. 7. In case you use Workbench 2.0 (or higher) use the mouse to drag
  154.    the FontShop and CanonPref icon into your Workbench prefs
  155.    drawer. If your Workbench disk does not allow this because
  156.    no space is left on disk, you can simply drag the programs
  157.    to any other wanted drawer.
  158. 8. Start the CanonPref program if you are using Workbench 2.0 (or
  159.    higher). Adjust all parameters to your wanted environment.
  160.  
  161. Note:   the  install  program  will erase any previously installed
  162. CanonBJ10  drivers  without  asking  you  so.   Also note that the
  163. Commodore  CanonBJ10 driver is a subset of this driver and because
  164. of  this,  you  get  all the functions of the Commodore driver and
  165. even more.
  166.  
  167.  
  168.  
  169.  
  170.                       Workbench Preferences
  171.                       ---------------------
  172.  
  173. While  the Workbench preferences program is described in detail in
  174. your  system  manual,  there are three settings which belong to the
  175. driver documentation:
  176.  
  177. Density:
  178.  
  179. The driver supported graphic densities:
  180.  
  181. Density   X-DPI    Y-DPI   X*Y-DPI
  182.    1       360     360     129600
  183.    2       180     180      32400
  184.    3       120     360      43200
  185.    4       180     360      64800
  186.    5       240     360      86400
  187.    6       360     180      64800
  188.    7       360     360     129600
  189.  
  190. The  desired density can be selected in Preferences or in case you
  191. use  Workbench  2.0  "PrinterGfx".  Most application programs also
  192. allow you to select the density before doing a graphic dump.  This
  193. setting overrides temporarily the preferences density setting.
  194.  
  195. Paper Size:
  196.  
  197. Under  Workbench 2 and 2.1 (or later) this driver supports the new
  198. introduced papersizes.  Anyway, DIN A4 users may select the Letter
  199. paper  size  instead  of  DIN  A4  to print a DIN A4 letter (2804
  200. dots wide) in the highest resolution (2880 dots wide).
  201.  
  202. PaperType:
  203.  
  204. A  papertype  of  SINGLE will eject a sheet with a Form Feed after
  205. every  print.  Form Feed after a graphic dump is sent according to
  206. the  SPECIAL_NOFORMFEED  flag.   You can use the FANFOLD papertype
  207. setting  to force several dumps to appear on the same page.  Also,
  208. if you need to run InitPrinter often, you may choose the papertype
  209. FANFOLD to avoid printing empty pages.
  210.  
  211. Note:   if  an  aRIN  (initialize) or an aRIS (reset) command gets
  212. sent,  the  printer  will  eject  the  printed  page  even if your
  213. PaperType  is  FANFOLD.  Also note, aRIN is automaticly sent after
  214. loading the driver into memory the first time.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.                      The Driver in detail
  223.                      --------------------
  224.  
  225. Now  that  you have installed and adjusted the driver, printer and
  226. preference  setting,  there  are some details you should know when
  227. using the driver.
  228.  
  229. This   driver  automatically  checks  for  the  processor  in  use
  230. (68000,68010   or   68020,68030,68040)  and  optimizes  the  print
  231. routines  accordingly.   Because  of  this, there is no need for a
  232. special .020 version of the driver in order to get the most out of
  233. your turbo amiga.
  234.  
  235. Aborting  printing  may  often  leave  the  printer  in an unknown
  236. status.  This causes erronious printing on the next dump.  In case
  237. you  abort printing, also switch your printer off and on. Also run 
  238. InitPrinter in order to bring back the printer in a known status.
  239.  
  240. The driver supports the unique Amiga commands shown below:
  241.  
  242. Name        Escape sequence        Function         Defined By
  243. aRIS             ESCc               reset              ISO
  244. aRIN             ESC#1           initialize           Amiga
  245. aIND             ESCD                lf                ISO
  246. aNEL             ESCE            return,lf             ISO
  247. aSGR0            ESC[0m        normal char set         ISO
  248. aSGR4            ESC[4m         underline on           ISO
  249. aSGR24           ESC[24m        underline off          ISO
  250. aSGR1            ESC[1m         boldface on            ISO
  251. aSGR22           ESC[22m        boldface off           ISO
  252. aSHORP0          ESC[0w         normal pitch           DEC
  253. aSHORP2          ESC[2w           elite on             DEC
  254. aSHORP1          ESC[1w           elite off            DEC
  255. aSHORP4          ESC[4w        condensed fine on       DEC
  256. aSHORP3          ESC[3w         condensed off          DEC
  257. aSHORP6          ESC[6w          enlarged on           DEC
  258. aSHORP5          ESC[5w          enlarged off          DEC
  259. aDEN6            ESC[6"z       shadow print on         DEC
  260. aDEN5            ESC[5"z       shadow print off        DEC
  261. aDEN4            ESC[4"z       doublestrike on         DEC
  262. aDEN3            ESC[3"z       doublestrike off        DEC
  263. aDEN2            ESC[2"z           NLQ on              DEC
  264. aDEN1            ESC[1"z           NLQ off             DEC
  265. aSUS2            ESC[2v        superscript on         Amiga
  266. aSUS1            ESC[1v        superscript off        Amiga
  267. aSUS4            ESC[4v         subscript on          Amiga
  268. aSUS3            ESC[3v         subscript off         Amiga
  269. aSUS0            ESC[0v      normalize the line       Amiga
  270. aPLU             ESCL          partial line up         ISO
  271. aPLD             ESCK         partial line down        ISO
  272. aFNT0            ESC(B  Typeface  0 (default): Courier DEC
  273. aFNT1            ESC(R     Typeface  1: Line Printer   DEC
  274. aPROP2           ESC[2p       proportional on         Amiga
  275. aPROP1           ESC[1p       proportional off        Amiga
  276. aVERP0           ESC[0z      1/8" line spacing        Amiga
  277. aVERP1           ESC[1z      1/6" line spacing        Amiga
  278. aSLPP            ESC[nt      set form length n         DEC
  279. aPERF               ESC[nq       perf skip n (n>0)       Amiga
  280. aPERF0           ESC[0q         perf skip off            Amiga
  281. aSLRM            ESC[Pn1;Pn2s   L&R margin             DEC
  282. aCAM             ESC#3         Clear margins          Amiga
  283. aTBC3            ESC[3g       Clear all h tabs         ISO
  284. aTBC4            ESC[4g        Clr all v tabs          ISO
  285. aTBCALL          ESC#4       Clr all h & v tabs       Amiga
  286. aTBSALL          ESC#5        Set default tabs        Amiga
  287. aRAW             ESC[Pn"r Next 'Pn' chars are raw     Amiga
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.                        The CanonPref Program
  295.                        ---------------------
  296.  
  297. Beside  all  the functions mentioned in the chapter "The Driver in
  298. detail",  there  are  some  more  options  unique to the CanonBJ10
  299. driver.   These  options are controlled using commodore's standard
  300. environment  variables.   Those  variables can be set by using the
  301. CLI setenv command, or by using the CanonPref preferences program.
  302.  
  303. CanonPref  provides  a nice and intuitive user interface and needs
  304. at  least  Workbench  2 to run.  In case you don't use Workbench 2
  305. (V37  and  above), see the chapter "Environment options" on how to
  306. control  the  special  option with a Kickstart 1.3 system.  If you
  307. don't  use these options, default values will be used.  The driver
  308. will  read  the  arguments  set by CanonPref on opening.
  309.  
  310. Note:   changes  to the options may not take place immeadiatly!!!!
  311. The  options  take  place with the next send aRIN or aRIS command.
  312. You  can send an aRIN command by using Initprinter or flushing the
  313. driver  out  of  memory  (WShell  users may use "Flush"; Commodore
  314. users  may  use the "Stack 40000000" command in order to do this).
  315. CanonPref  automatically flushes the driver out of memory for you.
  316. So  this  note  is  specialy  importent  for  CLI  users not using
  317. CanonPref.
  318.  
  319. CanonPref  can  be  controlled by the mouse and/or keyboard.  Each
  320. gadget  of the main program corresponds to the underscored letter.
  321. Pressing  that letter is equivalent to clicking on the gadget.  In
  322. the  case  of  a cycle gadget, you can use the upper or lower case
  323. letter  to  cycle  back  and  forth between them.  See your system
  324. manual  on  how to control the file- and fontrequester by keyboard
  325. or mouse.
  326.  
  327. All  windows  are opened directly under your mouse pointer, so you
  328. don't  have  to  move or scroll the screen to control the program.
  329. Also,  all  windows  are opened on the default public screen.  You
  330. may  specify  a  special  public  screen  by setting the Tool Type
  331. "PUBSCREEN=<screenname>"   (name   is  case  sensitive!)  and  the
  332. CanonPref  program  will  open  it's  windows  on your application
  333. programs  screen.   You  can  specify  a  screen from CLI with the
  334. PUBSCREEN option:
  335.  
  336.                    CanonPref PUBSCREEN <screenname>
  337.  
  338. For  instance,  if you use the ASDG text editor "CygnusEd" you may
  339. specify  "CanonPref  PUBSCREEN CygnusEdScreen1" and CanonPref will
  340. open  up  its  windows on the CEDPro screen.  Make sure the CEDPro
  341. screen is public before running the example.
  342.  
  343. After  starting,  the  main  window  will contain several gadgets,
  344. described  in  detail.  All those gadgets represent an environment
  345. variable  which  can  also  be  controlled  using  the  CLI setenv
  346. command.   I strongly recommend using CanonPref because it is user
  347. friendly and more secure.
  348.  
  349. Job End:              No Signal (default)
  350.                       Beep
  351.                       Flash
  352.                       Beep&Flash
  353.  
  354. If  the  printer device gets closed after a dump, you can tell the
  355. CanonBJ10 driver  to signal you the end of the print job.  This is
  356. especialy  usefull  on  huge graphic dumps wich might require some
  357. time.   There  are  two  kinds  of  signals.  You can cause a beep
  358. (CTRL-G)  on  the  printer,  a Flash (DisplayBeep) on the Amiga or
  359. both.
  360.  
  361. Note:   some  applications  print  graphics  in  stripes.   If the
  362. application  program closes the printer.device after every stripe,
  363. you  will  get a signal after each stripe.  So far, I havn't found
  364. an application program with such a bad behaviour.
  365.  
  366. Port:                 Disabled (default)
  367.                       Port 1
  368.                       Port 2
  369.                       Port 3
  370.  
  371. The  CanonBJ10 driver supports the arXon parallel switch box.  The
  372. arXon  switch  box  is  an  external  1  to  3  centronics  switch
  373. controlable  by  software.   You  can  ask the CanonBJ10 driver to
  374. automatically switch to a wanted port for printing and switch back
  375. to  the  previously used port after printing.  This enables you to
  376. use  a scanner, digitizer and printer from your Amiga's centronics
  377. port without switching between the devices "by hand".  Specify the
  378. wanted  printer port in "sbox_printer" and the default port (which
  379. should be set up after printing) in "sbox_active".  If you specify
  380. 0 (default) as the port, no switching will take place.
  381.  
  382. Note:   "sbox_active" MUST be specified before using the driver in
  383. order  to  enable  the  "sbox_printer"  command.   This is because
  384. "sbox_active"  is  used  to  determine  whether  a  switch  box is
  385. installed  or  not.   Information  about  the  switch  box  can be
  386. obtained from:
  387.  
  388.                           arXon GmbH
  389.                       Assenheimer Str. 17
  390.                       D-W-6000 Frankfurt
  391.                             Germany
  392.                     Tel:  (++49)-69-7896891
  393.                     Fax:  (++49)-69-7896878
  394.  
  395. Custom Res-X:         0-65535 dots (default 0)
  396.  
  397. If   the   selected   papersize  in  preferences  (Workbench  2.0:
  398. "Printer")  is  CUSTOM,  this  option  allows  you  to specify the
  399. horizontal  resolution of the printed paper.  For instance, if you
  400. use  Workbench  1.3,  you can specify a X-resolution of 2804 dots,
  401. which  is equal to the DIN A4 size.  If you specify 0 (default) as
  402. X-resolution,  the US-LETTER resolution of 2880 dots will be used.
  403. The allowed range is 0 to 65535 dots.
  404.  
  405. Top Margin:           1 - <page length-1>  (default 1)
  406.  
  407. If  "Enable  Form"  is  set  to  ON  (checkmark  on), "Top Margin"
  408. specifies  the  top  margin  in lines.  The top margin defines the
  409. vertical distance between the top of the page and the base line of
  410. the first line on the page.  When the cut sheet paper loading mode
  411. (MAN,  SF1,  or  SF2) is selected, this command is ignored.  Using
  412. this  option together with the preference settings for left, right
  413. margin  and  page  length,  you  are  totaly  free in defining the
  414. margins of a page.
  415.  
  416. Enable Form:          not checked (default)
  417.                       checked
  418.  
  419. If  "Enable Form" is set to ON (checkmark on), page length (as set
  420. in preferences), top margin (defined by CanonTop), and perforation
  421. skip  (defined  by CanonPerf) will be defined by the driver.  Some
  422. applications  require  a  well  defined paper size and margins for
  423. printing   forms.    The   CanonBJ10   driver  provides  you  such
  424. possibilities!
  425.  
  426. Perforation Skip:     0 - (form length-1)  (Default: 0 lines)
  427.  
  428. If  "Enable  Form" is set to ON (checkmark on), "Perforation Skip"
  429. specifies the number of lines that the printer skips at the end of
  430. each  page.   This  causes  the  printer  to  skip the perforation
  431. between  pages  of  continuous  forms.   If 0 lines are specified,
  432. perforation  skip  will  be  disabled.  If the specified CanonPerf
  433. value  is  greater than or equal to the form length (as defined in
  434. the WB preferences program), the skip perforation is cancelled and
  435. the top and bottom margins become inactive.
  436.  
  437. Font Download:         checked (default)
  438.                        not checked
  439.  
  440. If  you  set  this  option (checkmark on), the printer driver will
  441. automatically  download  fonts  created  by  you  or  the FontShop
  442. program.   In  case  you  don't need the download feature, you can
  443. disable this feature without deleting or moving the font files.
  444.  
  445. Paper Length:
  446.  
  447. This  is a read only gadget showing the paper length as defined in
  448. Workbench  preferences.   You  can  use  the  value  to  set  your
  449. perforation  skip and top margin value.  Changes made to the paper
  450. length  preferences  are  automatically  detected by the CanonPref
  451. program  and  the  gadget  is updated immeadiately without exiting
  452. CanonPref.
  453.  
  454. Timeout:               1 - 999 (default 30)
  455.  
  456. In  case  huge  amounts  of  data  are  transfered to the printer,
  457. rendering a picture by the device is much faster than the transfer
  458. of  the  picture to the printer.  If this happens, a requester may
  459. appear  on the screen, saying "Printer trouble...".  The requester
  460. appears  because  the printer device thinks no data got transfered
  461. because  of  a hard- or software failure.  In reality your printer
  462. was busy with feeding a new paper.  With CanonTime you can specify
  463. a timeout before the printer device brings up the error requester.
  464. The  CanonTime  var  is  especially usefull when printing multiple
  465. pages  or  downloading huge fonts using the drivers automatic font
  466. download abilty.  A value of 1 to 999 seconds is allowed.  Setting
  467. a  high  timeout  value  also  has it's drawbacks:  in case a real
  468. error  appears,  you  also  have to wait the given time before you
  469. really can cancel the print job.
  470.  
  471. Instead  of  defining  a  huge  timeout, there is another solution
  472. available:   use  the  CMD  program  (see  you  Workbench disk) to
  473. redirect  the  parallel/serial  output  to  a file on disk.  After
  474. this,  use  the copy command or a printer spooler to copy the file
  475. to  "par:".   Using this technique, you can safely specify a small
  476. amount of seconds before a timeout.
  477.  
  478. Customize Tabs...:
  479.  
  480. The  ellipsis  (three  dots)  in  this gadget means, that an extra
  481. window will be opened when you select this gadget.  The gadgets of
  482. the  upcoming  window  let  you customize the horizontal tab stops
  483. settings  of  your  printer.  This is usefull for printing program
  484. listings  and  tables.   For instance:  you can change the default
  485. tab stops settings:
  486.  
  487.          1         2         3         4         5
  488. 12345678901234567890123456789012345678901234567890...
  489. ----+---T+----+-T--+----T----+--T-+----+T---+---T+
  490.  
  491. to:
  492.  
  493.          1         2         3         4         5
  494. 12345678901234567890123456789012345678901234567890...
  495. ---T+-T--T--T-+T--T+-T--T--T-+T--T+-T--T--T-+T--T+
  496.  
  497. Up  to 28 tab stops may be defined.  All tab stops above the limit
  498. of  28  are  ignored and a requester will tell you so.  Horizontal
  499. tabs  are  selected and stored by the printer in character spaces,
  500. not  inches.  Thus, any change in the character spacing can change
  501. the  physical  locations  of  horizontal tabs on the line, but the
  502. logical  positions  remain  unchanged.  With PS fonts, a column is
  503. defined  as  the  width of the current space character at ASCII 32
  504. ($20).
  505.  
  506. You can set/unset a tab stop by simply clicking into the gadget at
  507. the  wanted  position.  A "T" is used for a tab stop.  The "-" and
  508. "+"  chars  are  used  for  helping  you  in  finding  the correct
  509. position.   Using  the  slider below the gadget you can scroll the
  510. "tab  stops"  gadgets to a wanted position.  With "Clear Tabs" you
  511. can  clear  all  tab stops.  With the "n:" and "Set every n chars"
  512. gadgets,  you  can  easily  set  tab stops with the same distance.
  513. Simply  enter  the  distance  into the "n:" gadget and select "Set
  514. every n chars".  Note:  the printer driver uses a default distance
  515. of  8.   If you want to reset you customized tabs stop settings to
  516. the  printer  default  values, simply call "Customize Tabs..." and
  517. the  window  will come up with a default "n:" value of "8".  Press
  518. "Set every n chars" to get the default values.
  519.  
  520. You  can  leave  the  window  with  the  "Use" or "Cancel" gadget.
  521. Changes  made  to  the tab stops settings are accepted with "Use".
  522. "Cancel"  leaves the tab stops unchanged and any changes made will
  523. be  lost.   Note:   "Use"  does  not save the changes made to your
  524. environment.   This is done by using the "Use" or "Save" gadget in
  525. the main window.
  526.  
  527. Greyscale Conv...:
  528.  
  529. The  ellipsis  (three  dots)  in  this gadget means, that an extra
  530. window will be opened when you select this gadget.  The gadgets of
  531. the  upcoming  window  let  you customize the greyscale conversion
  532. function of the printer driver.
  533.  
  534. You  can define various greyscale conversions for the graphic dump
  535. of  the driver.  This allows you to make a picture brighter (which
  536. is  specially  usefull in high density modes), darker, increase or
  537. decrease   contrast  level.   Now  using  this  feature  is  easy,
  538. understanding  it might not.  So let's try to describe some things
  539. and  after  reading  it twice, simply try it!  You'll be extremely
  540. satisfied with the results....
  541.  
  542. For more information see the "greyscale conversion" chapter first!
  543.  
  544. The  "Greyscale  Conversion"  window  contains  16  sliders.  Each
  545. slider represents a value between 0 and 15, were 0 means black and
  546. 15  white.   The  order  of  the  16 sliders goes from black (left
  547. bottom)  to  white  (right  upper  side).   For example, following
  548. function (which is the default linear conversion of the driver) is
  549. shown by the sliders:
  550.  
  551.  
  552.  
  553.        bright|                             15
  554.              |                           14        
  555.            13| <- <- <- <- <- <- <- <- 13
  556. O            |                       12 ^
  557.              |                     11   |
  558. U            |                   10
  559.              |                  9       ^
  560. T            |                8         |
  561.              |              7
  562. P            |            6             ^
  563.              |          5               |
  564. U            |        4
  565.              |      3                   ^
  566. T            |    2                     |
  567.              |  1
  568.          dark|0                         ^
  569.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  570.              dark                      13  bright
  571.  
  572.  
  573.                        I N P U T
  574.  
  575.  
  576. As  you  can easily see, a greyscale value of 13 is printed by the
  577. driver  as  greyscale  value of 13.  So no change.  To define this
  578. linear  greyscale  conversion, you can also click on the "default"
  579. gadget  in  the  lower right side of the window.  "Invert" inverts
  580. every  slider  setting  resulting  in  a printed "negativ" of your
  581. picture.  "gamma +" sets the 16 slider to a value defining a gamma
  582. corretion  function.   The  "gamma" conversion function provides a
  583. way to significantly brighten an image without losing much detail.
  584. "Gamma  -"  is  the  opposite of "gamma +" and results in a darker
  585. printout.  By repeatidly clicking on the "Bright" gadgets, you can
  586. make your printout darker ("Bright -") or brighter ("bright +").
  587.  
  588. You  can  leave  the  window  with  the  "Use" or "Cancel" gadget.
  589. Changes  made  to the conversion function are accepted with "Use".
  590. "Cancel"  leaves the conversion function unchanged and any changes
  591. made will be lost.  Note:  "Use" does not save the changes made to
  592. your  environment.   This  is  done  by  using the "Use" or "Save"
  593. gadget in the main window.
  594.  
  595. Cancel:
  596.  
  597. You  may  leave  the CanonPref program by clicking on the "Cancel"
  598. gadget.  Changes made to the settings will not be saved.
  599.  
  600. Use:
  601.  
  602. You  may  leave  the  CanonPref  program  by clicking on the "Use"
  603. gadget.   Changes  made  to the settings will be saved to the ENV:
  604. directory.   Note:   on normal Workbench 2.0/2.1 environments, all
  605. vars  in  the ENV:  directory are temporary and will be erased the
  606. next  time  you  boot  the  machine.  In case you want to make the
  607. settings permanent, use the "Save" gadget.
  608.  
  609. Save:
  610.  
  611. You  may  leave  the  CanonPref  program by clicking on the "Save"
  612. gadget.   Changes  made  to  the  settings  will  be  saved to the
  613. ENVARC: and ENV: directory for permanent and temporary use.
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.                      Environment Options
  623.                      -------------------
  624.  
  625. You can set options for the CanonBJ10 driver by using the "setenv"
  626. CLI  command instead of the CanonPref program.  This command saves
  627. your option in the "ENV:" directory using a file.  See your system
  628. manual  for  a  complete  description  of  the setenv and "getenv"
  629. command.   The  driver  will  read in the arguments on opening the
  630. printer  device.  In case you don't have enough memory, the driver
  631. refuses to open.
  632.  
  633. Note:   reading  the  options does not always mean they take place
  634. immeadiately.  So if you make changes by using "setenv", flush the
  635. driver  out  of  memory  or  run "Initprinter" in order to let the
  636. driver  know  about  your changes.  CanonPref will do this for you
  637. automatically.
  638.  
  639. Remember  that  environment  vars  (they  are stored in the "ENV:"
  640. directory)  are  normaly  erased by booting.  If you don't want to
  641. set  the  environment vars every time you boot, you can place them
  642. in  "ENVARC:"  (Workbench  2.0/2.1)  or  assign  "ENV:"  to  a non
  643. volatile  disk (KS 1.3).  Make sure you use the commodore "setenv"
  644. command  to set the environment vars!  Under KS 2 (or higher), the
  645. driver supports local and global environment vars!  Here is a list
  646. of  the  possible options and their meaning.  As usual, everything
  647. is case insensitve:
  648.  
  649.              SetEnv sbox_printer <0|1|2|3>  (Default: 0)
  650.  
  651. The  CanonBJ  driver  supports the arXon parallel switch box.  The
  652. arXon  switch  box  is  an  external  1  to  3  centronics  switch
  653. controlable  by  software.   You  can  ask  the  CanonBJ driver to
  654. automaticly  switch  to a wanted port for printing and switch back
  655. to  the  previously used port after printing.  This enables you to
  656. use  a  scanner, digitizer and printer from your Amigas centronics
  657. port without switching between the devices "by hand".  Specify the
  658. wanted  printer port in "sbox_printer" and the default port (which
  659. should be set up after printing) in "sbox_active".  If you specify
  660. 0 (default) as the port, no switching will take place.
  661.  
  662. Note:   "sbox_active" MUST be specified before using the driver in
  663. order  to  enable  the  "sbox_printer"  command.   This is because
  664. "sbox_active"  is  used  to  determine  weather  a  switch  box is
  665. installed or not.
  666.  
  667.                   SetEnv CanonBeep  0|1|2|3  (Default: 0)
  668.  
  669. If  the  printer device gets closed after a dump, you can tell the
  670. CanonBJ10  driver to signal you the end of the print job.  This is
  671. especially  usefull  on huge graphic dumps wich might require some
  672. time.   There  are  two  kinds  of  signals.  You can cause a beep
  673. (CTRL-G) on the printer, a DisplayBeep on the Amiga or both.
  674.  
  675.                       0 = No Action (default)
  676.                       1 = Printer beep (CTRL-G)
  677.                       2 = DisplayBeep
  678.                       3 = Printer beep + DisplayBeep
  679.  
  680. Note:    some   application   print   graphics  striped.   If  the
  681. application  program closes the printer.device after every stripe,
  682. you  will get a signal for each stripe.  So far, I havn't found an
  683. application program with such bad behaviour.
  684.  
  685.                   SetEnv CanonResX <num>  (Default: 0 dots)
  686.  
  687. If  the papersize is CUSTOM, this option allows you to specify the
  688. horizontal resolution for graphic dumps.  For instance, if you use
  689. Workbench 1.3, you can specify a resolution of 2804 dots, which is
  690. equal  to  the  DIN  A4  size.   If  you  specify  0  (default) as
  691. resolution,  the  US-LETTER  resolution of 2880 dots will be used.
  692. The allowed range for <num> is 0 to 65535 dots.
  693.  
  694.                   SetEnv CanonTime <num>  (Default: 0 seconds)
  695.  
  696. In  case  huge  amounts  of  data  are  transfered to the printer,
  697. rendering a picture by the device is much faster than the transfer
  698. of  the  picture  to  the  printer.  A requester may appear on the
  699. screen,   saying  "Printer  trouble...".   The  requester  appears
  700. because  the  printer device thinks no data got transfered because
  701. of  a hard- or software failure.  With "CanonTime" you can specify
  702. a  timeout until the printer device brings up the error requester.
  703. The  "CanonTime"  var is especially usefull when printing multiple
  704. pages  or downloading huge fonts, using the drivers automatic font
  705. download abilty.  If you specify 0 (default) as timeout, a timeout
  706. of  30  seconds  will  be  used.  A value from 1 to 999 seconds is
  707. allowed.   Instead  of  defining  a huge timeout, there is another
  708. solution  available:   use  the  "CMD"  program (see you Workbench
  709. disk)  to  redirect  the parallel/serial output to a file on disk.
  710. After  this, use the copy command or a printer spooler to copy the
  711. file  to  "par:".   Using this technique, you can safely specify a
  712. small number of seconds before a timeout.
  713.  
  714.        SetEnv CanonConv <num0-15>  (Default: 0,1,2,3,4,5,6,7,8,9,10,
  715.                                                 11,12,13,14,15)
  716.  
  717. You  can define various greyscale conversions for the graphic dump
  718. of  the driver.  This allows you to make a picture brighter (which
  719. is  specialy  usefull  in high density modes), darker, increase or
  720. decrease  contrast level, and do gamma correction.  Now using this
  721. feature  is  easy,  understanding  might not.  Simply try it after
  722. reading  the documentation!  You'll be extremly satisfied with the
  723. results....
  724.  
  725. For general information see the "greyscale conversion" chapter!!!
  726.  
  727. You  must  define exactly 16 greyscale values for CanonConv.  Each
  728. value  must  be  in  range from 0 to 15, were 0 means black and 15
  729. white.   The order of the 16 values goes from black to white.  For
  730. example,  you  want  to  define  following  function (which is the
  731. default linear conversion of the driver):
  732.  
  733.  
  734.  
  735.        bright|                             15
  736.              |                           14        
  737.            13| <- <- <- <- <- <- <- <- 13
  738. O            |                       12 ^
  739.              |                     11   |
  740. U            |                   10
  741.              |                  9       ^
  742. T            |                8         |
  743.              |              7
  744. P            |            6             ^
  745.              |          5               |
  746. U            |        4
  747.              |      3                   ^
  748. T            |    2                     |
  749.              |  1
  750.          dark|0                         ^
  751.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  752.              dark                      13  bright
  753.  
  754.  
  755.                        I N P U T
  756.  
  757.  
  758. As you can easily see, a greyscale value of 13 is printed by the
  759. driver as 13. So no change. To define this linear greyscale
  760. conversion, you must enter in CLI:
  761.  
  762.   SetEnv CanonConv "0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15"
  763.  
  764. Next time you print graphics, the new conversion function is used.
  765. Defining  and  editing  a  greyscale conversion function using the
  766. setenv  command  is  uncomfortable.  You can use the CanonPref for
  767. editing and defining a function.  When finished with defining, you
  768. can  get  the  values  set  in  CanonPref  by  using  the  "getenv
  769. CanonPref" CLI command.
  770.  
  771.        SetEnv CanonTab <num1-28>  (Default: 9, 17, 25,...)
  772.  
  773. This  environment  let  you  customize  the  horizontal  tab stops
  774. settings  of  your  printer.  This is usefull for printing program
  775. listings  and  tables.   For instance:  you can change the default
  776. tab stops settings:
  777.  
  778.          1         2         3         4         5
  779. 12345678901234567890123456789012345678901234567890
  780.         T       T       T       T       T       T
  781.  
  782.  
  783. with 'Setenv CanonTab "3 6 9 12 15 18" '  to:
  784.  
  785.          1         2         3         4         5
  786. 12345678901234567890123456789012345678901234567890
  787.   T  T  T  T  T  T
  788.  
  789. Up  to 28 tab stops may be defined.  All tab stops above the limit
  790. of   28   are  ignored.   All  previous  tabulators  are  cleared.
  791. Horizontal  tabs  are  selected and stored internally in character
  792. spaces, not inches.  Thus, any change in the character spacing can
  793. change  the physical locations of horizontal tabs on the line, but
  794. the  logical  positions remain unchanged.  With PS fonts, a column
  795. is defined as the width of the current space character at ASCII 32
  796. ($20).
  797.  
  798.        SetEnv CanonPerf <0-form length-1>  (Default: 0 lines)
  799.  
  800. If CanonForm is set to ON, CanonPerf specifies the number of lines
  801. that  the  printer skips at the end of each page.  This causes the
  802. printer to skip the perforation between pages of continuous forms.
  803. If  0  lines are specified, perforation skip will be disabled.  If
  804. the specified CanonPerf value is greater than or equal to the form
  805. length  (as  defined  in  the  WB  preferences  program), the skip
  806. perforation  is  cancelled  and  the top and bottom margins become
  807. inactive.
  808.  
  809.        SetEnv CanonTop <0-form length-1>  (Default: 0 lines)
  810.  
  811. If CanonForm is set to ON, CanonTop specifies the top margin.  The
  812. top  margin  defines  the vertical distance between the top of the
  813. page  and  the  base line of the first line on the page.  When the
  814. cut  sheet paper loading mode (MAN, SF1, or SF2) is selected, this
  815. command is ignored.
  816.  
  817.            SetEnv CanonForm  ON|OFF  (Default: OFF)
  818.  
  819. If  CanonForm  is  set to ON, page length (as set in preferences),
  820. top margin (defined by CanonTop), and perforation skip (defined by
  821. CanonPerf) will be defined by the driver.
  822.  
  823.                  SetEnv CanonFont ON|OFF  (Default: ON)
  824.  
  825. Using this switch, you can enable or disable font download without
  826. actually  deleting the download fonts in your ENV:  and/or ENVARC:
  827. directory.   Set  this var to "OFF" if you don't want any fonts to
  828. be downloaded.
  829.  
  830.             SetEnv CanonFontDat <fontfilename>  (Default: not used)
  831.  
  832. If you generate fonts with the FontShop program for automatic font
  833. download,  the  fonts  will  be  saved in the ENV:  and, if "Prefs
  834. (save)" was selected, ENVARC:  directory.
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.                         BJ10-FontShop
  844.                         -------------
  845.  
  846. The  FontShop  program  allows  you to generate and download fonts
  847. from   your  Amiga  to  the  BJ printer.  As a font source it uses
  848. standard  Amiga  fonts.   In  case  you  use  a  font  with a high
  849. resolution  (ie. size)  you  can get the best print quality out of
  850. your printer using an unlimited pool of fonts.
  851.  
  852. FontShop provides a nice and intuitive user interface and needs at
  853. least  Workbench 2 to run.  In case you don't use Workbench 2 (V37
  854. and  above),  you  may generate download font files on a Workbench
  855. 2.0/2.1 machine and copy them.
  856.  
  857. FontShop  can  be controled by mouse and/or keyboard.  Each gadget
  858. of  the  main  program  corresponds  to  the  underscored  letter.
  859. Pressing  that  letter is equal to clicking on the gadget.  In the
  860. case of a cycle gadget you can use the upper and lower case letter
  861. to cycle back and forth.  See your system manual on how to control
  862. the file- and fontrequester by keyboard or mouse.
  863.  
  864. Each  window  is opened directly under your mouse pointer.  So you
  865. don't  have  to  move or scroll the screen to control the program.
  866. Also,  all  windows  are opened on the default public screen.  You
  867. may  specify  a  special  public  screen  by setting the Tool Type
  868. "PUBSCREEN=<screenname>"   (name   is  case  sensitive!)  and  the
  869. FontShop  program  will  open  it's  windows  on  your application
  870. programs  screen.   You  can  specify  a  screen from CLI with the
  871. "PUBSCREEN" option:
  872.  
  873.                  FontShop PUBSCREEN <screenname>
  874.  
  875. For  instance,  if  you use the ASDG texteditor "CygnusEd" you may
  876. specify  "FontShop  PUBSCREEN  CygnusEdScreen1"  and FontShop will
  877. open  up  its  windows on the CEDPro screen.  Make sure the CEDPro
  878. screen is public before running the example.
  879.  
  880. After  starting  the  main  window will show up containing several
  881. gadgets  described  later  in detail.  With "Select a font..." you
  882. can  invoke  the  system  font  requester  and  choose  a font for
  883. download.   The  printer can fully understand all fonts with up to
  884. 48  dots.   If you don't have such a huge font available, simply
  885. enter  the 48 point size into the gadget and the system will scale
  886. a  font,  so  that it fits 48 points.  A font size of 48 points is
  887. recommended  for  the  best  output quality.  If you choose a font
  888. greater  than 48 point, several or all character will be cut of at
  889. the  bottom  (only  the  48  upper  rows will be printed).  If you
  890. select  a font size with a baseline of 48, you may fully print all
  891. upper  case  characters  in huge size (for instance 8 CPI).  After
  892. selecting the font you get back to the main window with "OK".  Now
  893. you  can  download  the  font  to  the  printer by clicking on the
  894. "Download"  gadget.
  895.  
  896. NOTE:   MAKE  SURE  YOUR  PRINTER DIP SWITCHES ARE SETUP RIGHT FOR
  897. DOWNLOAD   FONTS   (see   the   "Installation"  chapter  for  more
  898. information).
  899.  
  900. There  are several things you can alter in the main window.  These
  901. are in most cases only for experienced users and will be discussed
  902. in the following list of possibilities:
  903.  
  904. Fonts:
  905.  
  906. This  is  a  readonly  field  and shows you the currently selected
  907. font.
  908.  
  909. CPI:
  910.  
  911. This  is  a  readonly  field and shows you the characters per inch
  912. (cpi)  of  the  selected  font.   The  cpi  number depends on your
  913. selected  font, font width, InterSpace and font mode (Proportional
  914. or Mono Spaced characters.
  915.  
  916. "Select a font...":
  917.  
  918. This  gadget  will  bring up the systems font requester.  Select a
  919. wanted  font  and  style  (underlined,  italics, bold, invers) for
  920. download.   Note:  the printers normal font height is 48 dots (and
  921. 36  dots wide).  You may download a smaller or greater font, but a
  922. font greater 48 dots will most likely be cut of at the bottom.  In
  923. case  you  only  want  to  use  the  upper  case  characters  of a
  924. downloaded  font,  you  may use a font heigher than 48 dots with a
  925. baseline of up to 48 dots.  If all upper case characters are above
  926. the  baseline,  everything  should  work  fine and you get "super"
  927. characters.   The  default baseline of a selected font is shown in
  928. the "Baseline" gadget after selecting a font.
  929.  
  930. There  are  several  commercial and public domain font collections
  931. available,  offering  you huge 48 dots high fonts in high quality.
  932. Also,   you   may   use   Intellifonts  (CompuGraphic)  from  Agfa
  933. Corporation  if you have installed the right diskfont library (see
  934. your   Kickstart   2  manual  for  more  information).   Over  250
  935. Intellifonts  are  available offering you a high quality output at
  936. variable  sizes  and  styles.   For information about Intellifonts
  937. write to:
  938.  
  939.             Intellifont Scaleable Typefaces
  940.             Agfa Corporation
  941.             90 industrial Way
  942.             Wilmington, MA 01887
  943.             USA
  944.             Tel: (508) 658-5600 ext. 2311
  945.  
  946. Also,  if  you  want  to  make  your  own  download chars or alter
  947. existing  fonts,  there  are  several  nice  and  easy to use font
  948. editors  available  on  the  amiga (public domain and commercial).
  949. Ask your dealer for it!
  950.  
  951. -->To:
  952.  
  953. This  is  a  cycle gadget.  If "Prefs (Use)" is selected, the font
  954. gets  downloaded  directly to ENV:  directory.  The printer driver
  955. will  download  the  saved  font the next time you send an aRIN or
  956. aRIS command.  If you want to save the font permanently instead of
  957. temporarily,  use  "Prefs (Save)".  This will save the font in the
  958. non  volatile  ENVARC:  directory.  You may also download the font
  959. directly  to  a  file for late use by selecting "File".  Such font
  960. files  can  be quickly downloaded from your application program or
  961. batch  file  in  huge  quantities.   If "File" is selected and the
  962. download  gets  started,  a  file  requester  will  ask  you for a
  963. filename.   Note:   the  font  files  must be copied to "par:" not
  964. "prt:"!
  965.  
  966. Space Mode:
  967.  
  968. This is a cycle gadget.  You may download a font to the printer in
  969. a  fixed  width (Mono Space) given in the "Char Width" gadget.  Or
  970. you may download the font with proportional spaced chars.  You may
  971. define a special space (InterSpace) between two proportional chars
  972. given you a lighter font impression.
  973. Note,  the  given  mode reflects the downloaded font mode, not the
  974. Amiga  font  mode.   You  may download a mono spaced Amiga font as
  975. proportional  printer  font  (ie.   kerning is used).  Even if the
  976. downloaded  font is mono spaced, the printer regards the font as a
  977. proportional  spaced font (even though it isn't).  After selecting
  978. a  new  font with "Select a font..." this gadget is altered to the
  979. mode of the new selected font.
  980.  
  981. Char Width:
  982.  
  983. This integer gadget can only be activated, if "Mono Space" mode is
  984. active.   With  this  gadget  you  may  define  the  width  of all
  985. characters  in dots.  After selecting a new font, the value of the
  986. gadget  will be set to the default width of the selected font.  In
  987. case  you  selected  a  proportional font, the gadget reflects the
  988. width of the widest character of that proportional font.
  989.  
  990. InterSpace:
  991.  
  992. This  integer gadget can only be activated, if "Proportional" mode
  993. is  active.   With this gadget you may define a microspace between
  994. downloaded proportional spaced characters.
  995.  
  996. Baseline:
  997.  
  998. With  this  integer  gadget you specify the number of dots between
  999. the  baseline and the top border.  After selecting a new font, the
  1000. Baseline  will automatically be set to the system baseline of that
  1001. font.
  1002.  
  1003.                      "T" char        next "T" char      
  1004.                   ----------------  --------- \
  1005.                   |  ----------  |  |  ----   |
  1006.                   |      |       |  |         |
  1007.                   |      |       |  |         |
  1008.                   |      |       |  |         |
  1009.                   |      |       |  |         |
  1010.                   |      |       |  |         |
  1011.                   |      |       |  |         |
  1012.                   |      |       |  |          \
  1013.                   |      |       |  |          /  font size
  1014.                   |      |       |  |         |
  1015.                   |      |       |  |         |
  1016.        Baseline-> |- - -  - - - -|  |         |
  1017.                   |              |  |         |
  1018.                   |              |  |         |
  1019.                   |              |  |         |
  1020.                   |              |  |         |
  1021.                   ----------------  ---       /
  1022.                   \_____  _______/ ^
  1023.                         \/         |
  1024.                       width        ------ InterSpace
  1025.  
  1026.  
  1027. Download:
  1028.  
  1029. After  clicking on this gadget, the download gets started.  Please
  1030. be patient, the download may take some time.  During download, all
  1031. gadgets are ghosted.
  1032.  
  1033. Quit:
  1034.  
  1035. Clicking  on  this  gadget  (or  the CloseWindow gadget) quits the
  1036. program.
  1037.  
  1038.  
  1039. Now some general things about the BJ10-FontShop you should take
  1040. care of:
  1041.  
  1042. FontShop  supports accents.  Though, some accents are generated by
  1043. combining  two  chars  (for instance ø = o + /).  When downloading
  1044. such  chars  in a small size and proportional mode, there might be
  1045. some  small  misalignments  (for instance causing a o/ instead of
  1046. ø).   You  can  avoid  such  problems by altering the size of that
  1047. special chars or downloading the font in mono space mode.
  1048.  
  1049. While  the amiga has a huge font table, the BJ10 is not capable of
  1050. holding  that  much  download  characters  in  its printer memory.
  1051. Because  of  this,  only  "usual" characters get downloaded to the
  1052. printer  and  others not.  The view not downloaded characters will
  1053. be printed in the normal resident font of the printer.
  1054.  
  1055. The  program  assumes  you  have  32KB Ram of download RAM in your
  1056. printer.   If you select a huge font, this RAM might not be enough
  1057. causing  some  char  definitions  to  be  ignored  by  the printer
  1058. (accents  are the first chars wich get lost in this case, so check
  1059. for them if you really need them!)
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.                      Greyscale Conversion
  1069.                      --------------------
  1070.  
  1071. While your Amiga is able to show color and greyscale pictures on a
  1072. monitor,  there  is  no way to reproduce those picture on a black
  1073. and  white  printer  like  the  Canon  BJ10.   In  order  to print
  1074. color/greyscale  pictures  the  printer driver converts colors and
  1075. greyscales  to  an  array  of simple b/w dots.  The greyscales and
  1076. colors  are  hereby simulated by using a 4 by 4 dither array.  The
  1077. main  process  of  this  function  is  done  by  a function called
  1078. "greyscale conversion".  This function takes a greyscale value and
  1079. translate  it to a value wich is finaly used to print the original
  1080. greyscale value.  The greyscale conversion makes sure, the printed
  1081. greyscale  matches the greyscale shown on your Amiga monitor most.
  1082.  
  1083. Because every printer and picture is different, you need a special
  1084. conversion  function  for  every  printer and picture.  Most Amiga
  1085. drivers  simply use a linear conversion function for every
  1086. picture. This means the amount of printed dots on your printer is
  1087. directly proportional to the greyscale level of your picture.
  1088. The  brightness  of  printed  picture  using  a  linear  greyscale
  1089. conversion is often not satisfying. There are two main reasons
  1090. this:
  1091.  
  1092. -  the greyscale levels shown on your monitor are not linear.  For
  1093. instance,  the  difference  between two neighboring dark greyscale
  1094. levels is not as big as between to brighter levels.
  1095.  
  1096. - the Canon BJ printers have a precise printerhead movement.  This
  1097. gives  you  the possibility to print 360 dots per inch (dpi).  But
  1098. there is one drawback, which most printers have:  a 1/360 inch huge
  1099. dot can not be printed.  The dot is a bit greater, which causes the
  1100. dots  to  overlap  each other.  This causes a dark printed picture
  1101. and a loss of contrast.
  1102.  
  1103. To  compensate  these  affects, the CanonBJ10 driver allows you to
  1104. customize  and  adjust the greyscale conversion function.  You can
  1105. also  do  some art work (for instance pseudo colors) by using this
  1106. function.
  1107.  
  1108. The Amiga printer.device supports up to 16 greyscale levels. These
  1109. levels are represented by values from 0 (black) to 15 (white). Now
  1110. let's have a look at the default linear conversion function:
  1111.  
  1112.  
  1113.  
  1114.        bright|                             15
  1115.              |                           14        
  1116.            13| <- <- <- <- <- <- <- <- 13
  1117. O            |                       12 ^
  1118.              |                     11   |
  1119. U            |                   10
  1120.              |                  9       ^
  1121. T            |                8         |
  1122.              |              7
  1123. P            |            6             ^
  1124.              |          5               |
  1125. U            |        4
  1126.              |      3                   ^
  1127. T            |    2                     |
  1128.              |  1
  1129.          dark|0                         ^
  1130.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  1131.              dark                      13  bright
  1132.  
  1133.  
  1134.                        I N P U T
  1135.  
  1136.  
  1137. As  you  can easily see, every greyscale level is unchanged by the
  1138. greyscale  conversion  function.   For  instance, a value of 13 is
  1139. unchanged.   Now  we  could  simply increase the brightness of the
  1140. output, by simply adding 1 to each value:
  1141.  
  1142.  
  1143.        bright|
  1144.              |                           1415        
  1145.            14| <- <- <- <- <- <- <- <- 13
  1146. O            |                       12 ^
  1147.              |                     11   |
  1148. U            |                   10
  1149.              |                  9       ^
  1150. T            |                8         |
  1151.              |              7
  1152. P            |            6             ^
  1153.              |          5               |
  1154. U            |        4
  1155.              |      3                   ^
  1156. T            |    2                     |
  1157.              |  1
  1158.              |0                         ^
  1159.          dark|                          |
  1160.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  1161.              dark                      13  bright
  1162.  
  1163.                        I N P U T
  1164.  
  1165. Now  the greyscale value of 13 would be printed as 14.  A drawback
  1166. for  brighten  up a picture this way is the greyscale value 14 and
  1167. 15.   Both levels would be printed with the same value of 15 which
  1168. means  white.  A better method to brighten up a picture is kind of
  1169. gamma   correction  function.   The  "gamma"  conversion  function
  1170. provides  a  way to significantly brighten an image without losing
  1171. much detail:
  1172.  
  1173.  
  1174.        bright|
  1175.              |                             15        
  1176.              |                           14
  1177.              |                         13
  1178. O            |                       12
  1179.              |                   1011
  1180. U            |                  9 
  1181.              |                8
  1182. T            |              7
  1183.              |          5 6
  1184. P            |        4
  1185.              |      3
  1186. U            |    2
  1187.              |
  1188. T            |  1
  1189.              |  
  1190.          dark|0
  1191.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  1192.              dark                         bright
  1193.  
  1194.                        I N P U T
  1195.  
  1196. As you can see, there is no detail lost because several levels got
  1197. totaly  black or white.  Though, some levels are printed using the
  1198. same  value.   You  can alter this function to brighten up your
  1199. picture even more.  Just try...
  1200. There  is  a  gadget for the above shown function in the CanonPref
  1201. program  called  "gamma +".  Simply click on the gadget to get the
  1202. function above and if you like, alter the function afterwoods.
  1203.  
  1204. You  can  make  a  darker  picture  the same way you brighten up a
  1205. picture.  Simply lower the levels instead of increasing them.
  1206.  
  1207. Now  there  is  even  more you can control by using the conversion
  1208. function.   For instance you can increase or decrease the contrast
  1209. of the printed picture. For increasing the contrast, you must
  1210. increase the steepness of the conversion function for instance
  1211. like this:
  1212.  
  1213.  
  1214.        bright|
  1215.              |                     15
  1216.              |                     14
  1217.              |                   13
  1218. O            |                   12
  1219.              |                 11
  1220. U            |                 10 
  1221.              |                9
  1222. T            |                8
  1223.              |              7
  1224. P            |              6
  1225.              |            5
  1226. U            |            4
  1227.              |          3
  1228. T            |          2
  1229.              |        1
  1230.          dark|        0
  1231.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  1232.              dark                         bright
  1233.  
  1234.                        I N P U T
  1235.  
  1236. To decrease the contrast, simply make the function more flat:
  1237.  
  1238.        bright|
  1239.              |
  1240. O            |
  1241.              |
  1242. U            |
  1243.              |                           1415
  1244. T            |                       1213
  1245.              |                   1011
  1246. P            |                8 9
  1247.              |            6 7 
  1248. U            |        4 5
  1249.              |    2 3
  1250. T            |0 1
  1251.              |
  1252.              |
  1253.              |
  1254.          dark|
  1255.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  1256.              dark                         bright
  1257.  
  1258.                        I N P U T
  1259.  
  1260. Using the greyscale conversion function, you are also able to
  1261. filter out parts of a picture with a special color. Just try and
  1262. I'm sure you'll be satisfied.
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.                      Hints & Trouble Shooting
  1271.                      ------------------------
  1272.  
  1273. *  In  case  of stripes and empty lines check your printer margins
  1274. (DIP  switches,  preferences  setting, settings within the program
  1275. you  use,...).   Also  make  sure  your  computer does have enough
  1276. memory.   Specialy Art Department (TM) Professional 2 users should
  1277. use  the  "MAXMEM"  option to make sure the driver does get enough
  1278. memory  for  printing  or  ADPro  will simply print trash or empty
  1279. lines.   About  100  kb  memory  should  be available before start
  1280. printing!
  1281.  
  1282. *  Data  should  be  sent  to the printer only via parallel.device
  1283. (par:)  or printer.device (prt:) and not both together as this may
  1284. confuse the printer.
  1285.  
  1286. *  In  case  you  found  a  problem with the driver, please send a
  1287. description  which makes it possible to reproduce the problem.  For
  1288. this purpose, you should provide following information:
  1289.  
  1290. -  The disk contains a Report program. Allways include the
  1291.    output of this program.
  1292. -  Which application program are you using and which version?
  1293. -  Which Workbench revision are you using?
  1294. -  Include a dump of the program as file (use the CMD program from
  1295.    the Workbench disk for this) and in printed form.
  1296. -  In case of problems with the FontShop program, also include
  1297.    the font.
  1298. -  and if possible: provide a copy of your used Workbench
  1299.    disk/application ready set up for printing
  1300.  
  1301. *  If  you  are  interested  in  buying  AmigaTeX from Radical Eye
  1302. Software, you should buy the dvipref AmigaTeX driver.  This driver
  1303. also needs the 360*360 fonts which come with the dvip6 driver.
  1304.  
  1305. *  FontShop  supports accents.  Though, some accents are generated
  1306. by combining two chars (for instance ø = o + /).  When downloading
  1307. such  chars  in a small size and proportional mode, there might be
  1308. some  small  misalignements  (for instance causing a o/ instead of
  1309. ø).   You  can  avoid  such  problems by altering the size of that
  1310. special chars or downloading the font in mono space mode.
  1311.  
  1312. * Downloaded fonts are not printed?  Check you dip switch setting
  1313. (see the "installation" chapter)!
  1314.  
  1315. *  Unable  to start FontShop and CanonPref?  Make sure you have at
  1316. least Kickstart 2.04 and Workbench 2.04 installed right.
  1317.  
  1318. *  Unable  to print?  Check you printer cable!  Also make sure the
  1319. CanonBJ10 driver is selected in the Workbench preferences program!
  1320.  
  1321. *  Printer  doesn't  work  under  Kickstart  2.04  while Kickstart
  1322. 1.2/1.3  works  fine?  Check your printer cables "online" and "out
  1323. of  paper"  lines!  Make sure they are connected right.  Also if a
  1324. device is connected to your serial port:  try after removing it!
  1325.  
  1326. *  Paper  sheets  are  ejected and you don't want them to be
  1327. ejected?  Check your Workbench "paper type" preferences.  Note:
  1328. the aRIN and aRIS command eject a "used" sheet of paper!  So it
  1329. might be totaly normal!
  1330.  
  1331. *  "Printer trouble..." requester?  Have a look at the "CanonTime"
  1332. environment  description  on  how  to  avoid  such requesters from
  1333. appearing!    Anyway,  clicking  on  "Resume"  will  continue  the
  1334. printings without losses.
  1335.  
  1336. * After sending data to the printer, the last page doesn't get
  1337. ejected? Check your Workbench preferences paper type setting.
  1338. Select "Single" sheet!
  1339.  
  1340. *  The  driver  doesn't print graphics?  There are several reasons
  1341. why this might happen.  First check you Workbench disk.  Make sure
  1342. it  is  as  least  Workbench  1.3  and  no  prerelease  version of
  1343. Workbench 1.3.  Also make sure your computer has enough memory for
  1344. printing graphics (100KB should be enough)
  1345.  
  1346. *  Your  graphic  dumps are not really black?  Try a different ink
  1347. cartridge and paper!  Believe me:  you can get a really black
  1348. dumps!
  1349.  
  1350. * After switching from Workbench 1.3 to 2.0/2.1 your dumps doesn't
  1351. have  the  same size and resolution?  This most likely will happen
  1352. to  users  using  the  DIN  A4  paper  size.   For  instance under
  1353. Workbench  1.3  you  used  the  Letter size and after switching to
  1354. Workbench 2.0/2.1 the DIN A4 size.  Because the CanonBJ10 supports
  1355. the  new  paper sizes (DIN A4,A5...) you get a different printouts
  1356. under Workbench 2.0/2.1.  Simply switch back to the Letter size to
  1357. get the same result.
  1358.                             _\/_
  1359. this is it....   END       /~  ~\
  1360.                          \| o  o |/
  1361.                      --------  -------  <- the author ;-)
  1362.                              \/
  1363.